Skip to content

Drop the ADR-017 aliases from edge and docs - #1198

Merged
duynhne merged 3 commits into
mainfrom
feat/remove-adr017-aliases
Oct 2, 2026
Merged

duynhne merged 3 commits into
mainfrom
feat/remove-adr017-aliases

Conversation

@duynhne

@duynhne duynhne commented Oct 2, 2026 •

Copy link
Copy Markdown
Collaborator

What

This is the homelab half of the ADR-017 contract step, plus the Kind pins for the contract releases. The in-service removals are duynhlab/payment-service#137 (v2.8.0) and duynhlab/shipping-service#212 (v1.10.0), both merged and tagged.

Change Files
Both edges stop matching the pre-v3 /payment/v1/public/webhooks prefix. mockpay already posts to …/payments/webhooks/mockpay kubernetes/infra/configs/envoy-gateway/routes/api.yaml, local-stack/gateway/eg/routes.yaml
e2e-audit A7 and the k6 smoke row expect the shipping alias to be 404 (ADR-017:97-100) local-stack/docs/e2e-audit.md, scripts/k6/smoke.js
docs/api records the removals, drops the aliases from known gaps, and the A18 summary row names the canonical recon path docs/api/{payments,shipping,microservices}.md
Kind pins: payment + mockpay 2.7.0 → 2.8.0, shipping 1.9.1 → 1.10.0 kubernetes/apps/services/{payment,shipping}.yaml, mockpay.yaml
CHANGELOG: Breaking Change → Services, Dependency → Services CHANGELOG.md

Release gate (passed)

The full local-stack E2E release audit ran from scratch on payment 14c1614 and shipping d2a85ce, using this branch's runbook and k6:

Phase Result
A A1–A22: 66/66, including A7 alias = 404; A15 drill; A13 expired | timer
k6 6 suites green, including smoke's removed alias is 404
B B1–B10
C C0–C22 (C9 settled by durable evidence)

Direct checks:

  • These return 404: payment/v1/protected/attempts/open, /protected/reconciliations/runs, /public/webhooks/mockpay (at the edge) and shipping/v1/public/estimate.
  • The canonical paths return 200, and the canonical webhook returns 401 when unsigned.
  • mockpay's real webhooks were processed.

Both tags carry a signed image, a clean Trivy scan and a GitHub Release.

Verified on Kind (branch overlay; main, including #1197's ClusterConnection, merged in)

  • payment, mockpay (2.8.0) and shipping (1.10.0) rolled out.
  • HTTPRoute api-payment-webhooks matches only /payment/v1/public/payments/webhooks.
  • make e2e GATE=kind: A17–A22, K4.1–K4.8, K5.2–K5.9 and SG.1–SG.4 all PASS.
  • On gateway.duynh.me: /shipping/v1/public/track 404, /shipments/track 200, POST /payment/v1/public/webhooks/mockpay 404.
  • ClusterConnection temporal-mop is intact.

make validate passes. After merge, run make flux-push from main.

The homelab half of the ADR-017 contract step, shipping with
payment-service v2.8.0 and shipping-service v1.10.0, which remove the
aliases in-service.

Both edges stop matching the pre-v3 /payment/v1/public/webhooks path.
e2e-audit A7 and the k6 smoke suite now expect the shipping alias to
answer 404, so a forgotten alias fails the gate instead of passing
it. docs/api records the removals and drops the aliases from the known
gaps.
The ADR-017 contract releases, which remove the expand-phase aliases
in-service. Both passed the full local-stack release audit from scratch.
@duynhne
duynhne marked this pull request as ready for review October 2, 2026 11:17
@duynhne
duynhne requested a review from duyhenryer as a code owner October 2, 2026 11:17
@pull-request-size pull-request-size Bot added size/L and removed size/M labels Oct 2, 2026
@duynhne
duynhne merged commit e17d6cd into main Oct 2, 2026
7 checks passed
@duynhne
duynhne deleted the feat/remove-adr017-aliases branch October 2, 2026 11:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant